home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
wildcat
/
chkmail.zip
/
CHKMAIL.DOC
next >
Wrap
Text File
|
1992-05-19
|
12KB
|
200 lines
╔═════════════════════════════════════════════════════════════════════════════╗
║ CheckMail for WildCat 3.0 - Version 1.03 ║
║ Copyright (c) 1992, Computer Discount Center, Ltd. ║
╚═════════════════════════════════════════════════════════════════════════════╝
This program was created out of a need to avoid running the SCAN option of
WildMail if no messages were entered by the BBS user. The command format is
as follows:
CHKMAIL [node] [/ANY]
To use this utility, simply put CHKMAIL.EXE into the batch file that runs your
bulletin board. Have the batch file run CHKMAIL.EXE immediately after the
WildCat program exits. If the [node] parameter is included, CheckMail will
check to see if the last user entered mail in the specified node, and/or if
the user called the TomCat Mail Door. The main reason to run the utility is
to greatly improve the speed of your system by only running the WM SCAN option
if a user entered mail into the message bases. The "/ANY" switch can be used
to indicate whether only netmail and echomail conferences should be checked,
or whether "any" conferences including local BBS conferences should be checked.
The program sets the DOS errorlevel to indicate whether you should run the
WM SCAN program as follows:
Errorlevel 1 - Messages were entered - run WM SCAN
Errorlevel 0 - No messages entered - no need to run WM SCAN
A sample batch file snippet follows:
.
.
.
WILDCAT /B %1 %2 <-- Runs WildCat BBS
CHKMAIL <-- Sets errorlevel if msg entered
IF ERRORLEVEL 1 GOTO SCANMAIL <-- If mail entered, run WM SCAN
IF ERRORLEVEL 0 GOTO BYPASS <-- If no mail entered, don't scan
:SCANMAIL
WM SCAN <-- Scan using WildMail
:BYPASS
GOTO FRONTDOOR <-- Return to Mailer
.
.
.
The CheckMail program works by examining the activity log to see whether any
messages were entered in the last session. Be sure to put CHKMAIL.EXE in the
same subdirectory as your ACTIVITY.xxx file. If you only want to watch for
messages in echo mail and netmail, put a copy of your AREAS.BBS and WM.CFG
files there too.
If you want to use CheckMail on other nodes, put the node number immediately
following the CHKMAIL command. Example for node 2:
CHKMAIL 2
If the activity log cannot be found in the current subdirectory, the program
exits with the error message:
"The activity log ACTIVITY.xxx could not be found."
As the program runs, a number of status messages may appear on the screen:
"No new mail added to conferences ..." - This means that the program did
not find where the last user
entered any messages. Program
will exit with ERRORLEVEL = 0.
"Mail added to conference(s) ..." - This means that the program
determined that the last user
did enter a message into at least
one conference. This message
appears if the /ANY switch is used
and a message is entered into any
conference. Program will exit with
ERRORLEVEL = 1.
"EchoMail added to conference(s) ..." - This means that the program
determined that the last user
did enter a message into at least
one echomail conference. This
message appears if the /ANY switch
is omitted and the user enters a
message into echomail. Program
will exit with ERRORLEVEL = 1.
"NetMail added to conference(s) ..." - This means that the program
determined that the last user
did enter a message into the
NETMAIL conference. This message
appears if the /ANY switch is
omitted and the user enters a
message into netmail. Program
will exit with ERRORLEVEL = 1.
"Mail Door Was Executed ..." - This means that the program
determined that the last user
called upon the TomCat Mail Door.
Even if the user did not upload a
reply, the program will still exit
with ERRORLEVEL = 1, because TomCat
does not indicate what happened
inside the door within the activity
log entry.
"Event Log Activity Was Ignored ..." - This means that while processing
the activity log, the program found
that a Wildcat soft event occurred
between the time the user logged
off, and the time the CheckMail
utility was run. The program will
ignore the event entry, and scan
backward until it finds the last
user login entry. Program will
continue to execute normally.
The current version of CheckMail is version 1.03. This newest release of
CheckMail will detect when the TomCat Mail Door was called by your user.
Note that the program will set the ERRORLEVEL to 1 WHENEVER TomCat is
called upon by the user, regardless of whether the user uploaded replies
or downloaded messages. This is because TomCat does not log what the
user did while in the mail door.
The program also will now by default only check conferences described as
"echomail" or "netmail". This can be turned off with the /ANY switch. To
determine which conferences are echomail or netmail, the program will
examine the AREAS.BBS file and WM.CFG file used by the Online Computer
Resources WILDMAIL 2.0 mail tossing program. If you are using other
networks other than Fido, or using a non-standard echomail system, then
using the /ANY switch will make the program watch for any type of message
and act accordingly.
*** NOTE: The AREAS.BBS file and WM.CFG file MUST reside in the
same directory as the CHKMAIL.EXE file !
Also, in earlier releases of the program, if Wildcat executed an event such
as the No Node Page event, which was executed as a "soft" event after a user
logged off, the program would see the entry from the event as a separate
log on. This has been fixed in version 1.02 by causing the program to
ignore the event entry in the activity log.
╔═════════════════════════════════════════════════════════════════════════════╗
║ * * * Modification List * * * ║
╟─────────────────────────────────────────────────────────────────────────────╢
║ ║
║ Version 1.00 - Introduced CheckMail For Wildcat 3.0. ║
║ ║
║ Version 1.01 - Provided Greatly Improved Speed for Mail Checking. ║
║ ║
║ Version 1.02 - Provided Support For TomCat Mail Door, and for ║
║ ignoring Activity Log entries created by the ║
║ Wildcat Event Handler. ║
║ ║
║ Version 1.03 - Provided the ability to only set the errorlevel for ║
║ echomail or netmail conferences, so that Wildmail does ║
║ not have to be run if the user enters a message into ║
║ a conference that is local to the BBS only. ║
║ ║
╚═════════════════════════════════════════════════════════════════════════════╝
** END OF CHKMAIL.DOC **
╔═════════════════════════════════════════════════════════════════════════════╗
║ This program is SHAREWARE. Please feel free to copy and distribute this ║
║ but DO NOT modify it in any way. Computer Discount Center, Ltd. will ║
║ not be liable for any loss resulting from the use of this program. ║
║ ║
║ ┌──────────────────────────────────────────────┐ ║
║ │ * * * Registration is only $5.00 * * * │ ║
║ │ │ ║
║ │ To register by phone, have your Visa │ ║
║ │ MasterCard, or Discover card ready, │ ║
║ │ and call (904) 823-9669. │ ║
║ │ │ ║
║ │ * OR * │ ║
║ │ │ ║
║ │ Please make checks payable to: │ ║
║ │ Computer Discount Center, Ltd. │ ║
║ │ and mail to address below: │ ║
║ └──────────────────────────────────────────────┘ ║
║ Please leave your comments and suggestions to: ║
║ ║
║ Computer Discount Center, Ltd. ║
║ 1260-B North Ponce de Leon Blvd. ║
║ St. Augustine, FL 32084 ║
║ (904) 823-9669 ║
║ ║
║ or you may leave Netmail to 1:3620/13, attention Jerry Ray. ║
║ Thank you for supporting the shareware concept. ║
╚═════════════════════════════════════════════════════════════════════════════╝
WildMail and WM is a trademark of Online Computer Resources.
WildCat is a trademark of Mustang Software.